Skip to content

Fern support - Add auth to WSS#28

Open
fern-support wants to merge 144 commits intomainfrom
fern-support/add-auth-to-wss
Open

Fern support - Add auth to WSS#28
fern-support wants to merge 144 commits intomainfrom
fern-support/add-auth-to-wss

Conversation

@fern-support
Copy link
Copy Markdown
Contributor

Overview

This PR aligns the smallest-ai spec with the newly supported auth in WSS. The old auth headers have been removed in the overrides.

fern-support and others added 30 commits January 27, 2026 20:42
…ption-to-text

Add unified SDK config, rename transcription to text, and fix AsyncAPI refs
…iles

Co-Authored-By: blank@buildwithfern.com <blank@buildwithfern.com>
Use product switcher for navigation and add icons to Atoms and Waves
Co-Authored-By: blank@buildwithfern.com <blank@buildwithfern.com>
Co-Authored-By: blank@buildwithfern.com <blank@buildwithfern.com>
fix: correct output_format enum, add v3.1 voice discovery, and fix unified SDK overrides
Python SDK:
- Add additional_init_exports to export AtomsClient, AsyncAtomsClient,
  WavesClient, and AsyncWavesClient directly from the package root
- Users can now do: from smallest_ai import AtomsClient, WavesClient

TypeScript SDK:
- Enable generateSubpackageExports to allow importing individual clients
- Users can now do: import { AtomsClient } from 'smallest-ai/atoms'

Co-Authored-By: blank@buildwithfern.com <blank@buildwithfern.com>
…eExports support

The previous version (2.6.3) did not support the generateSubpackageExports config option.

Co-Authored-By: blank@buildwithfern.com <blank@buildwithfern.com>
…-exports

feat: enable additional init exports for Python and TypeScript SDKs
- Add environments configuration in unified generators.yml with separate base URLs:
  - atoms: https://atoms-api.smallest.ai/api/v1
  - waves: https://waves-api.smallest.ai
- Add x-fern-server-name: waves to all waves OpenAPI and AsyncAPI endpoints
- Create new override files for add-voice, get-cloned-voices, and delete-cloned-voice endpoints
- This fixes the issue where waves requests were incorrectly sent to atoms-api.smallest.ai

Co-Authored-By: blank@buildwithfern.com <blank@buildwithfern.com>
Co-Authored-By: blank@buildwithfern.com <blank@buildwithfern.com>
Co-Authored-By: blank@buildwithfern.com <blank@buildwithfern.com>
…se-urls

fix: configure multiple base URLs for atoms and waves APIs
Co-Authored-By: blank@buildwithfern.com <blank@buildwithfern.com>
…t-waves

Enable websocket client generation for waves API
- Updated Atoms content with new pages for intro, platform, developer guide, and API reference tabs
- Updated Waves content for v4.0.0, v3.0.1, and v2.2.0 with new documentation structure
- Added new images and videos for both Atoms and Waves documentation
- Fixed image paths in MDX files to use correct relative paths
- Updated navigation YAML files to match new content structure

Co-Authored-By: blank@buildwithfern.com <blank@buildwithfern.com>
…ages

Co-Authored-By: blank@buildwithfern.com <blank@buildwithfern.com>
Co-Authored-By: blank@buildwithfern.com <blank@buildwithfern.com>
Co-Authored-By: blank@buildwithfern.com <blank@buildwithfern.com>
Co-Authored-By: blank@buildwithfern.com <blank@buildwithfern.com>
…ves-toggle

Update Atoms and Waves content with new documentation structure
devin-ai-integration bot and others added 27 commits February 27, 2026 22:03
Excludes atoms/agent, atoms/helpers, and waves/text_to_speech custom
client files from mypy checking. These fernignored files reference
dependencies (requests, loguru, fastapi, etc.) and generated modules
that aren't available to mypy, causing 32 errors in CI.

Co-Authored-By: blank <blank@buildwithfern.com>
fix: add mypy_exclude for custom fernignored code paths
…okbooks

- Add MCP as top-level tab with 5 pages (overview, manual-setup, tools,
  prompt-cookbook, troubleshooting) matching atoms-platform layout
- Rewrite quick-start to use Single Prompt "Create with AI" workflow
- Add 3 new cookbook examples: real_estate_leasing, pizza_ordering,
  sentry_integration
- Add meeting_bot to examples page
- Expand Observability section to "Observability & Integrations"
- Remove platform link from dev overview (plain text)

Made-with: Cursor
- Add ?utm_source=documentation&utm_medium=docs to all console.smallest.ai
  and app.smallest.ai links (MCP overview, manual-setup, troubleshooting;
  deep-dive phone-number, campaign)
- Add dev/build/analytics/sse-live-transcripts.mdx (endpoint, event types,
  lifecycle, cURL/JS/Node/Python examples) and link in Analytics nav

Made-with: Cursor
…ripts)

- Add /events path with GET, callId query param, 200 (text/event-stream), 400, 404
- Add Live Transcripts tag and place it first in API Reference layout
- Remove custom SSE MDX from API ref tab; endpoint now generated from spec

Made-with: Cursor
…est.ai base URL

- Replace /events with PR 22 version: summary, description, event_type enum,
  schema properties (event_id, timestamp, call_id, interim/user_transcription_text,
  tts_text, tts_latency), and examples for sse_init, user_interim_transcription,
  user_transcription, tts_completed, sse_close
- 400/404 use BadRequestErrorResponse and ApiResponse refs
- Live Transcripts tag description from PR 22
- servers url https://api.smallest.ai/atoms/v1 (was atoms-api.smallest.ai/api/v1)

Made-with: Cursor
…ettings

- atoms.yml: Add Admin section (Subscription & Plans, API Keys, Settings & Team)
- atoms.yml: Single-prompt Prompt section drop Language selection; Agent settings General first, then Language selection
- atoms.yml: Convo-flow Agent settings: General settings first
- URL migration: atoms-api.smallest.ai -> api.smallest.ai/atoms/v1 in events.mdx, client-libraries/overview.mdx, api-reference/openapi.yaml, generators.yml
- Intro admin: billing (Subscription & Plans tables), api-keys, account-team content from atoms-platform; UTM on app links
- Single-prompt general-settings: add First Message section from atoms-platform
- Convo-flow general-settings: Location line to Agent Settings -> General tab

Made-with: Cursor
docs: sync content with atoms-platform — MCP tab, quick-start, new cookbooks
* update: docs and api spec with new URLs

* fix: TTS playground fix

* fix: hyperlink updating

* fix: broken URLs
The waves and atoms generators.yml files had SDK generator groups (python-sdk,
ts-sdk, go-sdk) with autorelease enabled, which conflicted with the unified
config. The waves config was generating to the same repos as unified but without
an explicit package_name, causing the Python generator to derive 'smallest_ai'
from the org name instead of using the intended 'smallestai'.

This removes the groups and autorelease sections while keeping the API
definitions intact (still referenced by the unified config via relative paths).

Co-Authored-By: blank <blank@buildwithfern.com>
…generators

fix: remove legacy SDK generator groups from waves and atoms configs
… Agents / Models

- Atoms Platform tab now appears first in navigation (before Product Overview)
- Product toggle renamed: Atoms → Voice Agents, Waves → Models
- Add availability: deprecated to Conversational Flow Agents section
- Fix all nav display names to Title Case matching Mintlify
- Add Campaigns overview, SSE Live Transcripts to Developer Guide
- Restructure Developer Guide: separate Operate section
- Add Reference section to Platform tab
Content sync:
- Sync 11 diverged pages from atoms-platform/docs (quick-start, welcome,
  intro, cookbooks, convo-flow overview, MCP pages, quickstart, etc.)
- Add campaigns/overview.mdx (was missing)
- Add 7 images (API keys screenshots, platform settings, etc.)

Link fixes:
- Rewrite all 69 internal links from Mintlify paths to Fern URL paths
- Fix Discord icons to fa-brands fa-discord
- Fix all image paths to relative paths

UX improvements:
- Add Deprecated badge to all Conversational Flow card references (9 cards)
- Rewrite Getting Help page with Discord, Showcase, Support CardGroups
- Add "Still Have Questions?" section to FAQ with Discord/Email/Showcase
- Fix Cookbook/GitHub icons to fa-brands fa-github

API:
- Add POST /product/import-phone-number (BYOSIP) endpoint to OpenAPI spec
- Update telephony.mdx with SIP import documentation
- Rename: How to TTS → Sync & Async, Stream TTS → Streaming
- Rename: Voice Models & Languages → Voices & Languages
- Rename: HTTP Streaming → HTTP vs Streaming vs WebSockets
- Add Model Cards as separate top-level tab
- Add Word Boosting to STT Features
- Remove Types of Cloning and Professional Voice Cloning from nav
- Remove PVC Best Practices from nav
- Add Vercel AI SDK and OpenClaw to Integrations
- TTS/STT sections: quickstart before overview
- Section names: Text to Speech (Lightning), Speech to Text (Pulse)
…ations

Content sync:
- Update 8 diverged pages with richer Mintlify content (quickstart, overview,
  how-to-tts, stream-tts, authentication, introduction, STT quickstart, etc.)
- Add 3 new pages: Lightning v3.1 model card, Pulse model card, TTS cookbook
- Add 2 new integration pages: Vercel AI SDK, OpenClaw
- Sync Vercel AI SDK and OpenClaw with latest branch updates

Assets:
- Add 2 audio files (tts-sample-hello.wav, stt-sample-audio.wav)
- Add 4 images (API keys screenshots)

Fixes:
- Models page: add Deprecated badge on v2, link cards to model cards,
  move Tip below STT section, fix card icons
- Fix all Discord icons to fa-brands fa-discord, GitHub to fa-brands fa-github
- Fix STT pre-recorded features card links (were giving 404s)
- Add deprecated badges to Lightning v2 API ref pages
- Convert Next Steps bullet lists to CardGroup on pronunciation dicts,
  best practices, voice cloning pages
- Fix TTS quickstart image alignment (consistent 700px width)
- Fix Voices & Languages page title
- Fix pvc-best-practices stale link
- Add word-boosting.mdx content
@github-actions
Copy link
Copy Markdown

@abhishekmishragithub
Copy link
Copy Markdown
Collaborator

@willkendall01 is this PR good to merge?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

9 participants